Release 10.1A: OpenEdge Development:
ADM Reference

enableWidget

Enables the object or objects identified in the name list. For SmartDataFields, it runs the enableField function. Note that enableField is not a generic SmartDataField function, therefore this API is only supported for SmartDataFields that have enableField defined. If a field in the list is not found, or a SmartDataField without enableField is included in the list, enableWidget returns FALSE.

Location: visual.p

Parameters:

INPUT namelist AS CHARACTER

The name of one or more objects, separated by commas.

Returns: LOGICAL

Notes:

Data fields are added to the EnabledFields and EnabledHandles properties to ensure that once the field is enabled by the API, it remains so enabled.
Local fields are added to the EnabledObjFldsToDisable property when the property is not set to (None) or (All). This action ensures that once a field is enabled by the API, it remains enabled. It could also result in adding a field that was not included in the EnabledObjFldsToDisable property initially to the property by a call to this API. If this behavior is not desired, do not use the enableWidget function or manipulate the EnabledObjFldsToDisable property after using the function to remove the field.
Examples:

The following illustrates the use of this method in 4GL code for use with a graphical user interface:

IF widgetIsModified("customerviewv.discount":U) THEN enableWidget("Self.terms":U).

The following illustrates the use of this method in DHTML code for use with a Web browser:

if (logic.widgetIsModified(‘customerviewv.discount’)) logic.enableWidget(‘orderviewv.terms’);